home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / tc800.arc / TC800.DOC < prev   
Text File  |  1987-01-05  |  47KB  |  862 lines

  1.  
  2.                               Turbo CALC(tm) v8.00
  3.  
  4.                  Copyright (c) 1985, 1986: by P & M Software Co.
  5.                  Turbo CALC is the trademark of P & M Software Co.
  6.  
  7.        Turbo CALC is "User Supported" software.  If you like the program,
  8.        use it, and want to see it supported and improved in the future, a
  9.        contribution of $35 would be appreciated.  Please copy and share
  10.        this program with your friends, even if you are unable to make a
  11.        contribution.
  12.  
  13.  
  14.                        Send Contributions to:
  15.  
  16.                           P & M Software Co.
  17.                           9350 Country Creek #30
  18.                           Houston, Tx 77036
  19.  
  20.  
  21.        For further information concerning the TC registration plan, please
  22.        refer the the file, REGISTER.DOC, which comes with this package.
  23.  
  24.        Turbo CALC is intended to be powerful, yet easy to use.  It
  25.        supports a spreadsheets ranging in size from, 8192 rows by 2 columns,
  26.        to 90 rows by 256 columns.  And supports many math, statistical and
  27.        financial functions.  Hopefully the user can begin using the program
  28.        without reading a lot of documentation, but some information is
  29.        necessary before one can begin.  The program requires a minimum of 256k
  30.        and can use as much as 640k.
  31.  
  32.        For the advanced spreadsheet user, Turbo CALC supports up to 500
  33.        range names and virtually unlimited macro capability.
  34.  
  35.        Version 6.00 and later of Turbo CALC includes a text editor with
  36.        the program.  You begin by executing the .COM file, then after the
  37.        copyright notice, there will appear a menu from which you can select
  38.        either 1. the calc program, 2. the edit program, or 3. exit to DOS.
  39.        The calc and edit programs are stored as .CHN, .000, and .001 files.
  40.        They must be present for the system to operate.
  41.  
  42.        INSTALLATION
  43.        ────────────
  44.        Turbo CALC is overlayed, the .000 and .001 files that came with the
  45.        program are the overlay files.  They must be present in the default
  46.        directory when the program is started, and they may not be removed
  47.        from the system during execution of the program.  You may change
  48.        directories after starting Turbo CALC, because Turbo CALC will
  49.        automatically find its way back to the original directory for the
  50.        overlays.  This is true for the the config file, .CNF, also.  The
  51.        config file holds the information about your printer & screen setup.
  52.        Also, the .000, .001 and .CHN files must be stored in the same
  53.        directory.
  54.  
  55.        As an alternative to having to all the files in the default directory
  56.        when the program starts, one can place the following code into the
  57.        AUTOEXEC.BAT file and then start Turbo CALC from any location:
  58.  
  59.                               PATH=c:\tc
  60.                               set TCPATH=c:\tc
  61.  
  62.        This assumes that drive C is the drive where Turbo CALC is stored and
  63.        TC is the directory.  The proper drive and directory should be sub-
  64.        stituted, as appropriate.
  65.  
  66.        DESCRIPTION
  67.        ───────────
  68.        First, let us examine the layout of the worksheet.  On screen,
  69.        there will be displayed 7 columns by 21 rows.  The user may scroll
  70.        both vertically and horizontally.  The vertical scroll is
  71.        accomplished by depressing the PgUp or PgDn keys.  This will
  72.        scroll 20 rows up or down, a single line scroll is achieved by
  73.        moving the cursor off the top or bottom of the screen, with the up
  74.        or down arrow keys.  The horizontal scroll is achieved by depressing
  75.        the Ctrl key and the left or right arrow keys simultaneously.  The
  76.        "scroll lock" may be activated by pressing the "Scroll Lock" key, an
  77.        indicator will show this at the bottom of the screen.  When the
  78.        "scroll lock" is NOT active, the user may scroll right or left by
  79.        moving the cursor off the right or left of the screen.  When
  80.        "scroll lock" is active, the cursor will wrap-around when moved
  81.        off the sides of the screen.
  82.  
  83.        On the top and bottom lines of the screen there appears some status
  84.        information: the current cell, the amount of memory available, the
  85.        auto-calc indicator, the current marked range, the current drive
  86.        and directory, the CAPS, NUM and SCRL lock indicators.  On the second
  87.        line of the screen will appear messages and the numeric or formula
  88.        content of the current cell.
  89.  
  90.        In general, the user may move the cursor to whatever cell he
  91.        desires, and enter the text, number or formula that needs to be in
  92.        that location.  If entering text, it can overwrite cells to the
  93.        right, but may not be longer than 80 characters.
  94.  
  95.        When you begin to enter something into a cell, the first keystroke
  96.        is VERY important.  It will determine the type of item stored in
  97.        the cell: a formulas begins with the '(' character,  a number with 0
  98.        thru 9, '+', '-' or '.', and text with any other character.  If you
  99.        desire to enter a text string that begins with a number, 0 thru 9,
  100.        you must prefix it with a single quote character, thusly: '109.
  101.        The quote will show on the screen, but not in the printed report.
  102.        When making the first keystroke of a cell, some keys have different
  103.        meanings, than on succeeding keystrokes.  For example, the left and
  104.        right arrow keys will move the cursor around the worksheet, but during
  105.        the entry of data into a cell, these keys will act to move the cursor
  106.        within the cell, to edit the data.  Other keys that behave
  107.        differently, are the Home, End and "/" keys.  The Home and End keys
  108.        move the cursor to the beginning or the end of the worksheet, but
  109.        during the entry of data, they move to the beginning or end of the
  110.        current cell.  Also during data entry, the Esc key will act to
  111.        finish the entry and move to the cell below, so that a column of
  112.        numbers may be entered with the Num Lock turned on.
  113.  
  114.        If you depress the "/" key, at the start of a cell, a list of
  115.        commands will appear, any of the displayed commands may be
  116.        executed by pressing the indicated letter.  For experienced users,
  117.        the commands may be entered directly, without using the "/" key,
  118.        by pressing the Alt key and the command letter together.
  119.  
  120.        Following are two lists.  The first is a list the the cursor
  121.        control and editing keys.  The second is a list of the command
  122.        letters.
  123.  
  124.  
  125.                               Action                  Action
  126.        Key Name          During Data Entry           Otherwise
  127.        ────────────────╥──────────────────────╥─────────────────────
  128.        /               ║ Put a "/" in literal ║ Display the menu of
  129.                        ║ data in cell.        ║ commands.
  130.        ────────────────╫──────────────────────╫─────────────────────
  131.        \               ║ Put a "\" in literal ║ Display the macro keys
  132.                        ║ date in cell.        ║ for entry or change.
  133.        ────────────────╫──────────────────────╫─────────────────────
  134.        F1              ║ Produces the help    ║ Produces the help
  135.                        ║ screens.             ║ screens.
  136.        ────────────────╫──────────────────────╫─────────────────────
  137.        F2              ║ No action.           ║ Enter edit mode on
  138.                        ║                      ║ current cell.
  139.        ────────────────╫──────────────────────╫─────────────────────
  140.        F3              ║ Switch to the text   ║ Switch to the text
  141.                        ║ edit module.         ║ edit module.
  142.        ────────────────╫──────────────────────╫─────────────────────
  143.        F4              ║ Enter/edit/list the  ║ Enter/edit/list the
  144.                        ║ range names.         ║ range names.
  145.        ────────────────╫──────────────────────╫─────────────────────
  146.        Up Arrow        ║ Finish entry and     ║ Move to cell above.
  147.                        ║ move to cell above.  ║
  148.        ────────────────╫──────────────────────╫─────────────────────
  149.        Down Arrow      ║ Finish entry and     ║ Move to cell below.
  150.                        ║ move to cell below.  ║
  151.        ────────────────╫──────────────────────╫─────────────────────
  152.        Left Arrow      ║ Move 1 character to  ║ Move to cell on the
  153.                        ║ the left.            ║ left
  154.        ────────────────╫──────────────────────╫─────────────────────
  155.        Right Arrow     ║ Move 1 character to  ║ Move to cell on the
  156.                        ║ the right.           ║ right.
  157.        ────────────────╫──────────────────────╫─────────────────────
  158.        PgUp            ║ Finish entry and     ║ Move up 1 screen.
  159.                        ║ move up 1 screen.    ║
  160.        ────────────────╫──────────────────────╫─────────────────────
  161.        PgDn            ║ Finish entry and     ║ Move down 1 screen.
  162.                        ║ move down 1 screen.  ║
  163.        ────────────────╫──────────────────────╫─────────────────────
  164.        Home            ║ Move to the start of ║ Move to cell at the
  165.                        ║ the cell.            ║ start of worksheet.
  166.        ────────────────╫──────────────────────╫─────────────────────
  167.        End             ║ Move to the end of   ║ Move to cell at the
  168.                        ║ the cell.            ║ end of worksheet.
  169.        ────────────────╫──────────────────────╫─────────────────────
  170.        Ctrl + End      ║ Erase contents of    ║ Erase current cell
  171.                        ║ cell from cursor to  ║ entirely.
  172.                        ║ end of cell.         ║
  173.        ────────────────╫──────────────────────╫─────────────────────
  174.        Ctrl + L. Arrow ║ Finish entry and     ║ Scroll to the left.
  175.                        ║ scroll to the left.  ║
  176.        ────────────────╫──────────────────────╫─────────────────────
  177.        Ctrl + R. Arrow ║ Finish entry and     ║ Scroll to the right.
  178.                        ║ scroll to the right. ║
  179.        ────────────────╫──────────────────────╫─────────────────────
  180.        Ctrl + PgUp     ║ Finish entry and go  ║ Go to top of the
  181.                        ║ to top of worksheet. ║ worksheet.
  182.        ────────────────╫──────────────────────╫─────────────────────
  183.        Ctrl + PgDn     ║ Finish entry and go  ║ Go to end of the
  184.                        ║ to end of worksheet. ║ worksheet.
  185.        ────────────────╫──────────────────────╫─────────────────────
  186.        Tab             ║ Finish entry and     ║ Move to cell on the
  187.                        ║ move to cell right.  ║ right.
  188.        ────────────────╫──────────────────────╫─────────────────────
  189.        Shift + Tab     ║ Finish entry and     ║ Move to cell on the
  190.                        ║ move to cell left.   ║ left.
  191.        ────────────────╫──────────────────────╫─────────────────────
  192.        Ins             ║ Toggle Insert Mode.  ║ Toggle Insert Mode.
  193.                        ║ Fat cursor = Insert. ║ Fat cursor = Insert.
  194.        ────────────────╫──────────────────────╫─────────────────────
  195.        Del             ║ Delete character at  ║ Delete cursor at
  196.                        ║ cursor.              ║ cursor.
  197.        ────────────────╫──────────────────────╫─────────────────────
  198.        Backspace       ║ Delete character to  ║ No action.
  199.                        ║ left of cursor.      ║
  200.        ────────────────╫──────────────────────╫─────────────────────
  201.        Enter           ║ Finish entry.  Stay  ║ No action.
  202.                        ║ in current cell.     ║
  203.        ────────────────╫──────────────────────╫─────────────────────
  204.        Esc             ║ Finish entry and     ║ Move cursor to the
  205.                        ║ move to cell below.  ║ cell below.
  206.                        ║ Nice for using NUM   ║
  207.                        ║ Lock mode with a     ║
  208.                        ║ column of numbers!   ║
  209.        ────────────────╨──────────────────────╨─────────────────────
  210.  
  211.  
  212.  
  213.        Command Table: With Alt key, or preceded by the "/" key.
  214.                       The "/" key brings up the command list.
  215.        ─────────────────────────────────────────────────────────────
  216.        Q         Exit to DOS.
  217.        ─────────────────────────────────────────────────────────────
  218.        Space     Remove command list and return to worksheet.
  219.        ─────────────────────────────────────────────────────────────
  220.        L         Produce a directory list.
  221.        ─────────────────────────────────────────────────────────────
  222.        N         Change to new directory and/or disk drive.
  223.        ─────────────────────────────────────────────────────────────
  224.        R         Read worksheet from disk into memory.  There are
  225.                  two options offered when ALT-R is selected: 1) to
  226.                  clear memory before reading or 2) to merge the file
  227.                  into memory.  The first option, to clear memory, is
  228.                  the more usual, especially for people who have
  229.                  separate worksheets.  The "merge" option is very
  230.                  handy for people who want to combine together smaller
  231.                  worksheets, the merge will bring in the file at the
  232.                  current cursor location.  Any formulas in the merged
  233.                  file will be adjusted if they do not use absolute
  234.                  addressing.
  235.        ─────────────────────────────────────────────────────────────
  236.        S         Store worksheet from memory onto disk.
  237.  
  238.                  Both the R and S commands assume the .SSF extension
  239.                  if the user doesn't specify one.  If no extension
  240.                  is desired end the filename with a '.' and no ext-
  241.                  ension will be used.
  242.        ─────────────────────────────────────────────────────────────
  243.        E         Erase part or all of the current worksheet from
  244.                  memory.  If you elect to erase only a part of the
  245.                  worksheet, you can set the range to be erased before
  246.                  the erasure begins.  For example: press Alt-E to begin,
  247.                  then press R and set the desired range, after the
  248.                  range has been set press P to erase the selected range.
  249.                  Menus are provided by the program to lead you thru
  250.                  this procedure.  If you select P prior to setting a
  251.                  range, only the current cell will be erased.
  252.        ─────────────────────────────────────────────────────────────
  253.        G         Perform the calculations specified by user
  254.                  formula.  Note: the worksheet is not automatically
  255.                  recalculated after one inserts/deletes a row or
  256.                  column, one should use the G command to do this.
  257.        ─────────────────────────────────────────────────────────────
  258.        P         Print the worksheet to disk file or printer.
  259.        ─────────────────────────────────────────────────────────────
  260.        V         View a graph.  This command will display a bar
  261.                  graph of the selected range, with the selected
  262.                  labels.  The data range should not be more than
  263.                  6 lines deep, this is the maximum.  However, the
  264.                  program will display widths that range up to 70 or
  265.                  more columns, depending on how many lines are
  266.                  selected.  Refer to the GRAPH.SSF file for an
  267.                  example.  It is possible to ask for more than the
  268.                  maximum lines or columns, TC will simply truncate
  269.                  the request to fit.  After the graph has been viewed
  270.                  the program will ask if you wish to save the graph
  271.                  to disk.  This file is suitable for printing or further
  272.                  modification using a text editor.
  273.        ─────────────────────────────────────────────────────────────
  274.        F         Change cell format.  Each cell may have a
  275.                  different format.  The default is leading sign, no
  276.                  comma and no currency symbol.  You may choose 1 of
  277.                  6 different formats: financial, percent, scientific,
  278.                  hidden, date, and the default.  If the date format is
  279.                  chosen, the cell is treated as if it contained a Julian
  280.                  date and then it is converted to one of three sub-formats:
  281.                  DD-MMM-YY, DD-MMM or MMM-YY.  You will be given you choice
  282.                  of these 3 date formats, if you select the date type.
  283.                  If the financial format is chosen, you will be given the
  284.                  choice of 4 sub-formats:
  285.                     A.  $1,000- .... Dollar sign and comma insertion.
  286.                     B.   1,000- .... Comma insertion.
  287.                     C.  (1,000) .... Dollar sign and comma insertion,
  288.                                      parens for negative.
  289.                     D. $(1,000) .... Comma insertion, parens for negative.
  290.        ─────────────────────────────────────────────────────────────
  291.        W         The width of each column defaults to 10, but it can
  292.                  be changed with this command to any value between
  293.                  0 and 30.  After setting the width, the user is asked
  294.                  if the column should be given the "blank zero" attribute.
  295.  
  296.                  Note: If a column width of 0 is chosen, then this has
  297.                  the same effect as if the whole column had the "hidden"
  298.                  format.  Anything in a 0 width column or with the
  299.                  "hidden" format, will appear on the status line at
  300.                  the top of the screen, but will not appear in the
  301.                  worksheet.
  302.        ─────────────────────────────────────────────────────────────
  303.        B         Mark the start of the range at the current cell.
  304.        ─────────────────────────────────────────────────────────────
  305.        K         Mark the end of the range at the current cell.
  306.        ─────────────────────────────────────────────────────────────
  307.        H         The user may specify that columns are to be held
  308.                  on the left of the screen and not horizontally
  309.                  scrolled.  4 maximum.
  310.        ─────────────────────────────────────────────────────────────
  311.        I         Insert Row or Column.  Formula will be adjusted
  312.                  to reflect their new locations.  Absolute addresses
  313.                  may be used, by placing a '0' before the row.  For
  314.                  example 'C5' is a relative cell address and would
  315.                  be adjusted if needed, but 'C05' is an absolute
  316.                  cell address and would not be adjusted.   Recalculation
  317.                  does not automatically take place after execution
  318.                  of this command.
  319.        ─────────────────────────────────────────────────────────────
  320.        D         Delete Row or Column.  Formula will be adjusted
  321.                  as given above for 'I'.  If the range option is
  322.                  selected, then the rows or columns that fall within
  323.                  the specified range will be deleted.  Note: only
  324.                  rows or columns are deleted, not both at the same
  325.                  time.  Recalculation does not automatically take
  326.                  place after execution of this command.
  327.        ─────────────────────────────────────────────────────────────
  328.        J         Jump directly to a cell.  Avoid scrolling when you
  329.                  know where to go.
  330.        ─────────────────────────────────────────────────────────────
  331.        M         Move the indicated range to the current location.
  332.                  The user is given the opportunity to alter the
  333.                  range specification.  Formula are adjusted as
  334.                  above for 'I'.  This command senses overlaping
  335.                  ranges, and will adjust so that an ascending or
  336.                  descending move is done whenever needed.
  337.        ─────────────────────────────────────────────────────────────
  338.        C         Copy the indicated range to the current location.
  339.                  The user is given the opportunity to alter the
  340.                  range specification.  Formula are adjusted as
  341.                  above for 'I'.
  342.        ─────────────────────────────────────────────────────────────
  343.        O         Sort the indicated range into ascending order.  The
  344.                  sort key is the first column of the range and the
  345.                  rows within the range are arranged into ascending
  346.                  sequence based on the textual content of the key
  347.                  column (the first one in the indicated range).
  348.                  Note: only cells actually within the range are
  349.                  sorted, so the exact dimensions of the table
  350.                  that needs sorting should be given.
  351.        ─────────────────────────────────────────────────────────────
  352.        A         Toggle auto-calculate.  If many formulas are in the
  353.                  worksheet, it may save time to turn auto-calculate
  354.                  off, and manually calculate with the 'G' command.
  355.        ─────────────────────────────────────────────────────────────
  356.        Y         Import a file.  You may import either a standard
  357.                  ASCII text file or a DIF file.  DIF(tm) stands for
  358.                  Data Interchange Format and is commonly supported
  359.                  by many programs including 1-2-3(tm).  The DIF(tm)
  360.                  supports only the storage of the data, so the format
  361.                  control information and the formulas are not found
  362.                  in the in the DIF(tm) file.
  363.  
  364.                  If you select the text file import, the file will
  365.                  be read into the column where the cursor is located.
  366.                  Each line of the file will cause the import to go
  367.                  to the next row of the worksheet.
  368.        ─────────────────────────────────────────────────────────────
  369.        Z         Export a DIF(tm) format file.  Please read the above
  370.                  paragraph about for the "Y" command.  The output file
  371.                  will contain data only, no formulas or format control
  372.                  information.  Also, the DIF(tm) format is not as
  373.                  efficient as the Turbo CALC .SSF format, so the exported
  374.                  file will probably be about 10% to 300% larger than
  375.                  the original file.
  376.  
  377.                  Note: if you wish to export an ASCII text file, use
  378.                  the printout feature, ALT-P, which can be redirected
  379.                  to a file instead of the printer.
  380.        ─────────────────────────────────────────────────────────────
  381.        U         The user may control the screen colors via this
  382.                  command.  The colors are entered as numbers from
  383.                  the following list:
  384.  
  385.                    0 : Black             8 : Dark Grey
  386.                    1 : Blue              9 : Light Blue
  387.                    2 : Green            10 : Light Green
  388.                    3 : Cyan             11 : Light Cyan
  389.                    4 : Red              12 : Light Red
  390.                    5 : Magenta          13 : Light Magenta
  391.                    6 : Brown            14 : Yellow
  392.                    7 : Light Grey       15 : White
  393.  
  394.        ─────────────────────────────────────────────────────────────
  395.        T         This command acts as a toggle switch, it controls
  396.                  whether or not the current cell is protected.
  397.                  If a cell is protected, when the cursor moves
  398.                  to the cell, it appears in the same colors as a window
  399.                  frame, otherwise cells have normal cursor highlighting.
  400.                  One may not enter information into a protected cell,
  401.                  unless the protection is released.  This is a safeguard
  402.                  feature, to keep data from being accidentally
  403.                  destroyed.
  404.        ─────────────────────────────────────────────────────────────
  405.        Note: DIF is a trademark of Software Arts Products Corp.
  406.              1-2-3 is a trademark of Lotus Development Corp.
  407.  
  408.  
  409. Now some discussion about selected topics:
  410.  
  411. 1. Formulas.
  412.  
  413.    Formulas are composed of operational symbols, cell addresses,
  414.    constants, and functions.  Each formula is enclosed within
  415.    parenthesis, like this: (A1+C2+F4).  This formula would take
  416.    the content of the 3 cells and add them together, depositing
  417.    the result in the cell where the formula is located.
  418.  
  419.    The following function are available:
  420.  
  421.    Name      Description                             Usage
  422.    ────      ───────────                             ────────
  423.    ABS       Absolute value.                         ABS(p)
  424.    SQRT      Square root.                            SQRT(p)
  425.    SQR       Square.                                 SQR(p)
  426.    MOD       The remainder of p1 divided by p2.      MOD(p1,p2)
  427.    INT       Returns the integer portion of p.       INT(p)
  428.    ROUND     Rounds p to the n'th precision.         ROUND(p,n)
  429.              Where n is the number of digits after
  430.              the . of accuracy wanted.  For example:
  431.              ROUND(100.256,2) would produce 100.26 as
  432.              the result.
  433.  
  434.    PI        3.1415926536                            PI
  435.    SIN       Sine of angle in radians.               SIN(p)
  436.    ASIN      Arc sine.                               ASIN(p)
  437.    COS       Cosine of angle in radians.             COS(p)
  438.    ACOS      Arc cosine.                             ACOS(p)
  439.    TAN       Tangent of angle in radians.            TAN(p)
  440.    ATAN      Arc Tangent.                            ATAN(p)
  441.  
  442.    LN        Natural Log.                            LN(p)
  443.    LOG       Log base 10.                            LOG(p)
  444.    E         2.7182818285                            E
  445.    EXP       E raised to the p power.                EXP(p)
  446.  
  447.    NPV       Net present value of a series           NPV(i,r)
  448.                of future cash flows.
  449.    PMT       Mortgage payment per period.            PMT(pa,i,n)
  450.    PV        Present value of ordinary annuity.      PV(pp,i,n)
  451.    FV        Future value of ordinary annuity.       FV(pp,i,n)
  452.    RATE      Periodic rate needed to produce         RATE(fv,pv,n)
  453.                a future value.
  454.    TERM      The number of payment periods required  TERM(pp,i,fv)
  455.                for an annuity to grow to a future
  456.                value.
  457.    CTERM     The number of compounding periods       CTERM(i,fv,pv)
  458.                required for a present value to
  459.                future value.
  460.    IRR       Internal Rate of Return.                IRR(g,r)
  461.  
  462.    AVG       The average.                            AVG(r)
  463.    SUM       The sum of all item in range.           SUM(r)
  464.    COUNT     The number of items in range.           COUNT(r)
  465.    MIN       The smallest number in range.           MIN(r)
  466.    MAX       The biggest number in range.            MAX(r)
  467.    VAR       The population variance.                VAR(r)
  468.    STD       The population standard deviation.      STD(r)
  469.  
  470.    SYD       The depreciation for the specified      SYD(cst,sal,lif,per)
  471.                period, using the "Sum Of The Years
  472.                Digits" method.
  473.    SLN       The "Straight line" depreciation for    SLN(cst,sal,lif)
  474.                1 period.
  475.    DDB       The depreciation for the specified      DDB(cst,sal,lif,per)
  476.                period, using the "Double Declining
  477.                Balance" method.
  478.  
  479.    IF        Choose between two values.              IF(t,p1,p2)
  480.                p1 is returned if t is true,
  481.                p2 is returned if t is false.
  482.    NOT       Reverse true and false values.          NOT(t)
  483.    TRUE      Returns the value for true.             TRUE
  484.    FALSE     Returns the value for false.            FALSE
  485.    ERR       Returns the value for ERR.              ERR
  486.    ISERR     Returns the value for true if the       ISERR(p)
  487.                parameter has the ERR value,
  488.                otherwise returns the value for
  489.                false.
  490.    NA        Returns the value for NA.               NA
  491.    ISNA      Returns the value for true if the       ISNA(p)
  492.                parameter has the NA value,
  493.                otherwise returns the value for
  494.                false.
  495.  
  496.    DATE      Returns the Julian date from the        DATE(y,m,d)
  497.                calendar date given as a parameter.
  498.                The year maybe between 1800 and
  499.                2100 and the date is measured in
  500.                days from December 31, 1899.
  501.    TODAY     Returns the Julian date for today.      TODAY
  502.                Taken from the DOS clock, so if
  503.                you have set it wrong, then this
  504.                will be wrong.
  505.    DAY       Returns the day of the month,           DAY(p)
  506.                given the Julian date.
  507.    MONTH     Returns the month of the year,          MONTH(p)
  508.                given the Julian date.
  509.    YEAR      Returns the year, given the             YEAR(p)
  510.                Julian date.
  511.  
  512.    HLOOKUP   Table lookups find the largest table    HLOOKUP(trgt,tbl,ofs)
  513.                entry not greater than the target
  514.                value.  The "HLOOKUP" function
  515.                defines a horizontal table.
  516.    VLOOKUP   The "VLOOKUP" function defines a        VLOOKUP(trgt,tbl,ofs)
  517.                vertical table.
  518.  
  519.    Note: There are many examples in the sample spreadsheet that
  520.          accompanies the program.
  521.  
  522.    Where:  p,p1,p2 ... Constants, cell addresses or algebraic
  523.                          expressions.
  524.            i ......... Interest rate, may be any of the items
  525.                          listed for "p" above.  Note: all
  526.                          interest rates are stated in their
  527.                          fractional format, i.e. "10% = 0.1".
  528.                          Note: this is an interest rate per period
  529.                          and not per annum, however if the period
  530.                          in use is a year, then it is per annum.
  531.                          If a month is the period in use, then
  532.                          conversion from the yearly rate must
  533.                          be done by division by 12.
  534.            r ......... A range of cell addresses, i.e. "D4..H21".
  535.            pa ........ Principle amount, may be any of the items
  536.                          listed for "p" above.
  537.            n ......... Number of periods, may be any of the
  538.                          items listed for "p" above.
  539.            pp ........ Payment per period, may be any of the
  540.                          items listed for "p" above.
  541.            g ......... A guess at the interest rate, usually
  542.                          between 0.0 and 1.0.
  543.            pv ........ A present value, may be any of the items
  544.                          listed for "p" above.
  545.            fv ........ A future value, may be any of the items
  546.                          listed for "p" above.
  547.            t ......... A logical expression whose result is
  548.                          0.0 for false and non-zero for true.
  549.            y,m,d ..... May be any value listed for "p" above.
  550.                          They are the symbols for year, month and day.
  551.            trgt ...... May be any value listed for "p" above.  It is
  552.                          the value which is the target of the lookup.
  553.            tbl ....... A range of cell addresses that define the values
  554.                          to be searched to find the match for the target
  555.                          in a lookup.
  556.            ofs ....... May be any value listed for "p" above.  It is
  557.                          the value added to the matching entry's coordinates
  558.                          to find the answer in a lookup table.  Usually is
  559.                          a 1.
  560.            cst ....... The cost of an asset.
  561.            sal ....... The salvage value of an asset.
  562.            lif ....... The life expectancy of an asset.
  563.            per ....... The period for which depreciation is to be
  564.                          calculated.
  565.  
  566.    Formulas may be quite complicated, an example is:
  567.  
  568.                (A1+SIN(PI/2*(B2-C1)))
  569.  
  570.    The only limitations imposed are those of available memory and
  571.    the fact that no formula may be longer than 80 characters.
  572.    The financial and trig function are not recusive, for example
  573.    don't do this: (IRR(IRR(.2,D4..D20),E2..M2)), it won't work
  574.    very well, if at all.  If any of the formulas cannot calculate
  575.    the answer, for example if you ask for the SQRT of a negative
  576.    number, then the result will be ERROR and you will see the word
  577.    "ERR" in the result cell.
  578.  
  579.    Finally, a formula may contain the following symbols:
  580.  
  581.                 ^      Raise to the power.
  582.                 *      Multiplication
  583.                 /      Division
  584.                 +      Addition
  585.                 -      Subtraction
  586.                 :      Range summation, same as SUM function,
  587.                             i.e. (SUM(A1..B5)) is the same as (A1:B5)
  588.                 |      Logical OR
  589.                 &      Logical AND
  590.                 >      Greater than test
  591.                 <      Less than test
  592.                 =      Equal test
  593.                 >=     Greater than or equal test
  594.                 <=     Less than or equal test
  595.  
  596.    These are probably familiar, with the exception of the ":" for
  597.    range summation.  Let's say that you want to sum a column of
  598.    numbers, beginning at D1 and ending at D20, then this
  599.    expression would sum the column, (D1:D20).
  600.  
  601. 2. Overwritten cells.
  602.  
  603.    Turbo CALC will allow you to make text entries of any length up
  604.    to a maximum of 80 characters, numeric entries may be up to 11
  605.    characters.  Any text entry that exceeeds the cell width will
  606.    automatically lock the adjacent cell on the right.  The lock will
  607.    be relased when the length of the entry shrinks.
  608.  
  609. 3. The Range and the commands that use it.
  610.  
  611.    The range is shown on the bottom left of the worksheet screen.
  612.    It is of the form: cell address..cell address.  If you have not
  613.    set the range, it defaults to the beginning and ending cell of
  614.    the worksheet.  There are two methods of setting the range:
  615.    1st, you can make the beginning and ending cells with the B and
  616.    K commands, 2nd, whenever one of the commands that use the
  617.    range is invoked, you have the opportunity of changing the
  618.    range by entering the new range.  For example the Copy command
  619.    will give you a menu with 3 options: Range, Copy and eXit.  If
  620.    you select the Range option, you will be allowed to enter a new
  621.    range, in the same format as displayed at the bottom of the
  622.    screen.  Here are the commands affected by the range: Copy,
  623.    Move and Print.
  624.  
  625. 4. Printer Setup.
  626.  
  627.    If you select the Print command, one of the options presented
  628.    on the Print menu is "Setup".  If you select the Setup option
  629.    you will be able to control the margins and dimensions of the
  630.    printed report.  Also, you will be given the option called
  631.    Control.  The Control option allows you to specify printer
  632.    setup control codes and printer exit control codes.  These
  633.    control codes default to Form Feed characters, but you may
  634.    specify whatever necessary.  The convention for specifying
  635.    these codes is to use the decimal numbers representing the
  636.    control codes separated by commas.  You can also put plain text
  637.    in the control strings, if you surround the text with "
  638.    marks.  For example: "This is a control string",12,12
  639.    If this was the setup control string, when the print began the
  640.    program would send the following to the printer: 'This is a
  641.    control string' FF FF.  Of course, the quotes would not be
  642.    sent, and the FF is just a symbolic way to represent the form
  643.    feed character.  With this method, you may program your printer
  644.    in whatever way you wish.
  645.  
  646.    There are 2 dot commands for the printer.  If you put .PAGE in
  647.    column A of any row, it will cause a page break to occur at
  648.    that place.  The remainder of the row with the dot command
  649.    will not print.  After you have entered .PAUSE in column A of
  650.    a row, page breaks will cause a pause for you to insert the
  651.    next page and give you an option to reprint a page or exit
  652.    the print function.
  653.  
  654. 5. Internal Rate of Return.
  655.  
  656.    This function provides an iterative approximation for the
  657.    interest rate which will produce a zero for the Net Present
  658.    Value function.  The range for this function should include
  659.    present cash flows as well as future cash flows.  The approach
  660.    to finding the zero is as follows, 14 loops thru the
  661.    "Bisection Method", followed by up to 6 loops thru the
  662.    "Modified-False Position Method".  Usually the IRR function
  663.    will converge to within 0.000001.  In some instances, where
  664.    the cash flows turn negative in a later period, there are
  665.    multiple solutions, however IRR finds the closest one only.
  666.    Your guess input to this function should be between 0.0 and 1.0.
  667.    In some cases, the function will not converge, either the
  668.    solution is too small or too large, in these cases the function
  669.    will return ERR.  Try adjusting you guess and recalculate.
  670.  
  671. 6. Range names.  Range names may be up to 15 characters long.  They
  672.    may contain any alpha or numeric character.  They should not contain
  673.    any blank or punctuation characters.  Up to 500 ranges may be named
  674.    in each worksheet.  When referenced, the range name must be preceded
  675.    with a @ character.  This signals TC that a range name is being used.
  676.    Range names may be used anyplace a range or cell address is called for.
  677.    The F4 key is used to bring up the range names for editing or examination.
  678.  
  679. 7. The macro keys are the 10 function keys used in combination with Alt, Ctrl
  680.    and Shift.  These values in the macro keys are stored in the .CNF file and
  681.    are thus independent of the worksheet.  However, macros may be stored in
  682.    the worksheet, at any cell location, and referred to via a JUMP command
  683.    from the normal macro keys.  Thus macros may be quite long and complex.
  684.  
  685.    NOTE: cell addresses are not automatically relocated when they are
  686.          embedded in macros, so it is advisable to use the range name
  687.          feature in conjunction with macros - range names are automatically
  688.          relocated as required.
  689.  
  690.    Macros are simply a device to record keystrokes for playback at a later
  691.    time.  So if you have repetitive processes or processes that you are
  692.    setting up for others to use, then macros are very handy indeed.
  693.  
  694.    Since some of the keys on the keyboard cannot be easily recorded in a
  695.    macro, they have a special name assigned.  When using these special
  696.    names, enclose the name within {}.  For example: {END} is the way to
  697.    indicate the pressing of the End key.  Here is the list of special names:
  698.  
  699.       Name            Description
  700.       ----            -----------
  701.       UP              Up Arrow key.
  702.       DOWN            Down Arrow key.
  703.       LEFT            Left Arrow key.
  704.       RIGHT           Right Arrow key.
  705.       HOME            Home key.
  706.       END             End key.
  707.       PGUP            PgUp key.
  708.       PGDN            PgDn key.
  709.       INS             Ins key.
  710.       DEL             Del key.
  711.       BS              Back Space key.
  712.       ESC             Esc key.
  713.       TAB             Tab key.
  714.       BTAB            Backward Tab key.
  715.       ^END            Ctrl-End key combo.
  716.       EDIT            F2, means to edit current cell.
  717.       RANGE           F4, means to enter/edit/list range names.
  718.  
  719.    It is also possible to use a Carriage Return in a macro by using the
  720.    ~, tilde, character wherever a Carriage Return is required.  Also, it
  721.    is IMPORTANT to note, that when writing a macro in normal cell locations
  722.    it is often desirable to begin a line with either the / or \ characters.
  723.    This is not possible, because Turbo CALC will think that you mean to
  724.    execute an immediate command.  To allow you to do this, place the ~, tilde,
  725.    before the / or \ character, this will cause Turbo CALC to allow the
  726.    entry to be made.
  727.  
  728.    For example:
  729.  
  730.        /JA1~         Will not work if stored in a normal worksheet cell
  731.                      because Turbo CALC will execute the command immediately.
  732.  
  733.    Instead enter:
  734.  
  735.        ~/JA1~        The initial ~ is a throw-away, but it allows you to enter
  736.                      the command for later execution.
  737.  
  738.    There are some special / commands that appear only in macros:
  739.  
  740.        /Q            Quit the worksheet module.
  741.  
  742.        /XGca~        Transfer execution of the macro to the cell address "ca".
  743.  
  744.        /XCca~        Call a subroutine macro at the cell address "ca".
  745.  
  746.        /XR           Return from subroutine to the calling macro.  Execution
  747.                      pickups at the next instruction following the /XC in the
  748.                      calling macro.
  749.  
  750.        /XQ           Quit the macro and return to manual worksheet operation.
  751.  
  752.        /XNps~ca~     Input a numeric value and store at the cell address "ca".
  753.                      The string "ps" is used to prompt for input.
  754.  
  755.        /XLps~ca~     Input a literal value and store at the cell address "ca".
  756.                      The string "ps" is used to prompt for input.
  757.  
  758.        /XIcond~      Tests the condition and branch accordingly.  The "cond"
  759.                      contains some expression that is tested to be true.  If
  760.                      it is not found to be true, then execution of the macro
  761.                      continues with the next line of the macro, if it is true
  762.                      then the current line continues execution.  For example:
  763.  
  764.                         /XIb2>100~/XGg30~
  765.  
  766.                         If the contents of cell B2 is greater than 100 the
  767.                         macro will transfer execution to cell G30, otherwise
  768.                         it will continue execution with the next line following
  769.                         the /XI command.
  770.  
  771.  
  772.        /XMca~        Execute a menu stored at the cell address "ca".
  773.                      Here is a sample of a menu stored at cell address B2.
  774.                      The command words are stored in the first line, B2..D2,
  775.                      the command descriptions are in the next line, B3..D3,
  776.                      the macro commands which are executed when the user
  777.                      selects an option are stored immediately below the
  778.                      related option.  Each macro may be any number of lines
  779.                      long and is terminated with an empty cell.  The same
  780.                      is true for the width of the menu, it terminates when
  781.                      an empty column is found.
  782.  
  783.                  A               B               C               D
  784.            1
  785.            2                   Yes             No              Maybe
  786.            3                   First Choice    Second Choice   Third Choice
  787.            4                   No. 1~          No. 2~          No. 3~
  788.            5                                   ~/Q
  789.  
  790.  
  791. The Editor
  792. ──────────
  793.    Starting with version 6.00 of Turbo CALC, an editor is included
  794.    with the package.  This editor is largely the result of the
  795.    "Turbo EDITOR TOOLBOX"(tm).  The editor has been customized and
  796.    integrated with Turbo CALC, and it is planned that more customization
  797.    and intergration will occur in the future.  At this time,
  798.    the editor has quite a list of features, including the ability to
  799.    print in background while editing a 2nd file, and windows can open
  800.    so that 2 files may be edited/viewed side-by-side.  If you would
  801.    like to be able to customize your own editor, I suggest you purchase
  802.    the toolbox from Borland International Inc.  It is quite excellent and
  803.    there are no royalties!
  804.  
  805.  
  806.    Command List
  807.    ────────────
  808.      ^A       Left Word                   Larrow  To left on line
  809.      ^S       Left Character              Rarrow  To right on line
  810.      ^D       Right Character             ^Q^J    Jump to marker
  811.      ^F       Right Word                  ^Q^I    Toggle auto indent mode
  812.      Uarrow   Up Line                     ^Q^R    To top of File
  813.      Darrow   Down Line                   ^Q^C    To end of File
  814.      PgUp     Up Page                     ^Q^B    To begin of Block
  815.      PgDn     Down Page                   ^Q^K    To end of Block
  816.      ^W       Scroll Up                   ^Q 1    Jump to Marker 1
  817.      ^Z       Scroll Down                 ^Q 2    Jump to Marker 2
  818.      RETURN   New Line                    ....    ....
  819.      ^N       Insert Line                 ^Q 9    Jump to Marker 9
  820.      ^G,DEL   Delete Character            ^Q^Y    Delete Line Right
  821.      BKSP     Delete Left Character       ^Q^F    Find Pattern
  822.      ^I       Tab                         ^Q^A    Find and Replace
  823.      ^T       Delete Word
  824.      ^Y       Delete Line                 ^K^S    Save File & Resume
  825.      ^B       Reformat Paragraph          ^K^D    Save & open new file
  826.      Ins      Toggle Insert Mode          ^K^X    Save & exit to Menu
  827.      ^L       Find Next Occurrence        ^K^Q    Abandon & open new file
  828.      ^J       Beginning/End of line       ^K 1    Set Marker 1
  829.      Home     Move to beginning of line   ^K 2    Set Marker 2
  830.      End      Move to end of line          ...    ....
  831.      ^P       Insert Char by ASCII        ^K 9    Set Marker 9
  832.      ^O^O     Open new window
  833.      ^O^L     Set Left Margin             ^K^B    Begin Block
  834.      ^O^R     Set Right Margin            ^K^K    End Block
  835.      ^O^C     Center Line                 ^K^H    Hide Block
  836.      ^O^K     Change Case                 ^K^C    Copy Block
  837.      ^O^S     Set UNDO Limit              ^K^V    Move Block
  838.      ^O^W     Toggle Wordwrap Mode        ^K^Y    Delete Block
  839.      ^O^G     Goto other window           ^K^W    Write Block
  840.      ^O^I     Goto Column                 ^K^R    Read block
  841.      ^O^N     Goto Line                   ^K^M    Set marker
  842.      ^O^Y     Destroy window              ^K^T    Define tab width
  843.      F2       Switch to the CALC module    F10    Activate Pulldown Menus
  844.      ESC      Undo last change
  845.  
  846.    Note: Turbo EDITOR TOOLBOX is a trademark of Borland International Inc.
  847.  
  848.    Some useful options:
  849.  
  850.        With ^Q^F:  U  - For search that is case independent.
  851.  
  852.        With ^Q^A:  U  - As above for ^Q^F.
  853.                    G  - Global search.
  854.                    N  - Replace without asking.
  855.  
  856.    A hint:
  857.  
  858.        When using the ^P command to insert printer codes into the
  859.        text, you press ^P followed by the control character you want
  860.        to send to the printer.  You can enter only 1 control character
  861.        each time you press ^P.
  862.